home *** CD-ROM | disk | FTP | other *** search
/ More DosGames 2.0 / MORE - Dosgames 2.0 (Software Company)(1994).iso / dosgames / minhato / minhato.doc < prev    next >
Text File  |  1994-09-01  |  16KB  |  298 lines
  1.  
  2.         
  3.                                   INTRODUCTION
  4.         
  5.           This game of MIN-HA-TO was developed as a project for a program-
  6.         ming course in C language.  (I had already taught myself C, but I
  7.         needed the credits).  I have decided to release it as shareware
  8.         after many of my friends urged me to do so.  Who knows, maybe enough
  9.         people will register that I can upgrade my system.  NOT!  The game
  10.         was developed over the course of about four weeks in Quick C 2.5 and
  11.         assembler (for graphics speed) on a Zeos 386SX/16 computer.  While I
  12.         have developed many other programs, both at work and home, this was
  13.         my first attempt at a color graphics game.  Since my wife is Korean,
  14.         I decided to try and get her involvement by designing a Korean card
  15.         game.  She likes it so much that several more are planned.
  16.         
  17.           Since several more games are planned, I decided that this first
  18.         game could be distributed as shareware.  Then if people like it
  19.         enough to send in a payment, I would send them the other Korean
  20.         card games when they are completed.  Please feel free to copy and
  21.         distribute this game.
  22.         
  23.         
  24.                                   REQUIREMENTS
  25.         
  26.           This program requires a VGA monitor.  While it will work on a
  27.         monochrome VGA, I have not tested it thoroughly and the colors play
  28.         a large part in recognizing some of the cards so I don't recommend
  29.         using a monochrome system.
  30.         
  31.           The game will use a mouse if available, but one is not required.
  32.         
  33.           It also requires about 300K of free memory and makes no attempt
  34.         to use either expanded or extended memory in the system.  While the
  35.         program itself only takes up about 60K, the graphics for all of the
  36.         cards need almost 200K.
  37.         
  38.           
  39.         
  40.                                   INSTALLATION
  41.         
  42.           You may install the game to either a floppy disk or a hard disk.
  43.         
  44.           There are four files included with the game.  Please provide all
  45.         four files when distributing the game to your friends (or enemies).
  46.         
  47.           MINHATO.EXE - The program itself.
  48.         
  49.           MINHATO.DOC - This documentation file.
  50.  
  51.           HA-TO.CRD - The card graphics.
  52.         
  53.           REGISTER.DOC - Shareware Registration form.
  54.         
  55.           The DOC files are not required to play the game.  The MINHATO.EXE
  56.         and HA-TO.CRD files must be in the same directory to play the game.
  57.  
  58.         
  59.           Here are some example installation steps.
  60.         
  61.         
  62.           Installing to a hard disk from a .ZIP file -
  63.         
  64.           MD \MINHATO
  65.           PKUNZIP MINHATO.ZIP \MINHATO
  66.         
  67.           Installing to a hard disk from a floppy disk in drive A -
  68.         
  69.           MD C:\MINHATO
  70.           COPY A:*.* C:\MINHATO
  71.         
  72.           Installing to a floppy disk from a .ZIP file -
  73.         
  74.           PKUNZIP MINHATO.ZIP A:
  75.         
  76.         
  77.                               THE MUNDANE DETAILS
  78.         
  79.           To run the game, change into the directory where you installed
  80.         the game and type in MINHATO and press ENTER.  You may also specify
  81.         the path to the game instead of changing to the program's directo-
  82.         ry.  If desired, you can add the program's directory to the PATH
  83.         command of your AUTOEXEC.BAT file.  Then you can type in MINHATO at
  84.         any time to run the game.  See your DOS manual for more information
  85.         on the PATH command.
  86.         
  87.           After the cards are read from the disk a copyright notice is
  88.         displayed and three options are given: Begin, Help or Exit.  The
  89.         first time you play the game you should read through the help to
  90.         learn the combinations of cards that form up suits.  Once you exit
  91.         help the game will start.  Select Begin to by-pass the help screens
  92.         and start the game immediately.  I think you know what exit means.
  93.         
  94.           There are two pull down menus available in the game.  They are
  95.         the Game menu and the Help menu.  On the top row of the screen you
  96.         will see the title bar and current scores.  You may use the mouse
  97.         to click on either Game or Help to bring up a menu.  Also you may
  98.         press ALT+G to access the Game menu or ALT+H to access the Help
  99.         menu.
  100.         
  101.           The Game menu has five choices.  The New option will restart the
  102.         game.  It does not affect the high scores recorded.  The High Scores
  103.         option will display the number of games played, won and lost along
  104.         with some other meaningless statistics.  Information about high hands
  105.         is updated after every hand, but the game information is not updated
  106.         until the end of a complete game.  The high scores are recorded in
  107.         a file named MINHATO.SCR, which the program creates the first time
  108.         you play the game.  The Skill Level option pops up a box which allows
  109.         setting the computer to easy, medium or expert mode.  The Sound option
  110.         lets you turn the sound effects on or off.  It will show the current
  111.         setting.  The program will remember the last setting of the Skill
  112.         Level and Sound option.  The Exit option works as expected.
  113.  
  114.         
  115.           The Help menu has two choices.  The View Help option will bring
  116.         up the on-line help system.  It consists of 5 screens of rules and
  117.         hints.  An additionsl 6 screens will display the cards in their
  118.         proper suits along with some background information.  The Hint option
  119.         was designed for you to use until you memorize the card suits.  It
  120.         will briefly flash the card or cards the computer would play, if it
  121.         had your hand.  Usually this is the best move, but not always.
  122.         
  123.           Short-cut keys that are active when playing the game -
  124.         
  125.              F1 ..........  On-Line Help
  126.              Shift+F1 ....  Hint
  127.              F2 ..........  New Game
  128.              F3 ..........  View High Scores
  129.              F4 ..........  Toggle Sound on or off
  130.              Alt+F4 ......  Exit Game
  131.         
  132.         
  133.                               HOW TO PLAY THE GAME
  134.         
  135.           Much of this same information is also contained in the on-line
  136.         help available by pressing the F1 key.
  137.         
  138.           The game of MIN-HA-TO is similar to a game of GO FISH, with a
  139.         twist.  This game uses an Oriental deck of cards called HA-TO.  The
  140.         deck has 48 cards which are divided into 12 suits of four cards. 
  141.         Each suit has a picture meant to associate the suit with one of the
  142.         12 months of the year.  See the on-line help for a description of
  143.         all of the cards in the deck.
  144.         
  145.           The instructions below assume you are using a mouse.  To move a
  146.         card with the mouse, move the pointer to the card and press and
  147.         hold the left button to begin dragging the card.  Then move the
  148.         card until it is over a matching card and release the button.  When
  149.         releasing cards, placement is not critical, but since the cards
  150.         overlap it is better to drop the card slightly to the left than to
  151.         the right.  Be careful if two cards of the same suit are side by
  152.         side.  If you change your mind about the card you wish to play,
  153.         release the card anywhere away from the playing area and it will
  154.         move back to your hand so you can select a new card.
  155.         
  156.           To use the keyboard to play the game, move the pointer with the
  157.         arrow keys, then press ENTER or SPACE to select the card you want
  158.         to play.  Then move the pointer to a matching card and press ENTER
  159.         or SPACE again.
  160.         
  161.           You may select a new card if you change you mind by moving the
  162.         pointer to the new card and pressing ENTER or SPACE.  This will
  163.         unselect any previous card and select the new card.  When a card
  164.         is selected it is shifted up slightly.
  165.  
  166.  
  167.           During the game you and the computer will take turns matching a
  168.         card from your hand with one of the cards in the playing area. 
  169.         Once you play a card from your hand, you then turn over the next
  170.         card from the deck and attempt to match it with one of the cards in
  171.         the playing area.  This is repeated until all cards have been
  172.         played.  As you play, the current points you have won are shown on
  173.         the bottom line of the screen.  In this game, "My" means the computer
  174.         and "Your" means the person playing the game (usually a human).
  175.         
  176.           Your hand is displayed across the bottom of the screen and the
  177.         computer's hand is across the top.  Of course, you cannot see the
  178.         computer's cards, but don't worry, the computer does not look at
  179.         your cards.  To the right of the screen is the playing area and the
  180.         deck is just to the left of the playing area.  Both the computer's
  181.         hand and the deck can be recognized by the large blue RLP and 1992.
  182.         
  183.           You must play a card from your hand every round.  If you do not
  184.         have a match, or don't wish to make a match, you must add a card to
  185.         the playing area.  Do this by dragging a card to the playing area
  186.         and releasing it.
  187.         
  188.           If you attempt to illegally add a card to the playing area that
  189.         has a match, or accidently drop a card on a different suit, the card
  190.         will move back to your hand to indicate an illegal move.
  191.         
  192.           The twist in this game is the fact that many of the cards have
  193.         extra symbols drawn on them.  These extra symbols are worth points
  194.         when you win the cards.
  195.         
  196.           Nine of the cards also have Korean lettering on a sign.  Three of
  197.         them have black letters on orange signs and are called HUNG-DON. 
  198.         Three of them have white letters on orange signs and are called
  199.         CHO-DON.  The last three have black letters on blue signs and are
  200.         called CHUNG-DON.  If you win all three of the related signs, more
  201.         bonus points are awarded.
  202.         
  203.           In addition, three of the suits are considered trump suits and
  204.         provide bonus points if you win all four cards in the suit.  The
  205.         three trump suits are called CHO-SI-MA, PUNG-SI-MA and BE-SI-MA.
  206.         See the on-line help for a list of the special groups.
  207.         
  208.             The bonus points given to your hand are also subtracted from
  209.         your opponent's score.  Usually, the bonus points will win or lose
  210.         the hand.  To win the game often you must learn to recognize the
  211.         card groups that give extra points and play to win them.  A little
  212.         luck is also needed, but skill will give you the edge over the
  213.         computer.
  214.  
  215.           Once a hand is completed, the computer will show all the cards
  216.         that have points.  See the on-line help for the point values of the
  217.         cards.  If either you or the computer have won any special groups,
  218.         their names are displayed also.  When the computer wins one or more
  219.         of the special groups their names are shown at the top of the
  220.         screen.  When you win any of the special groups, their names are at
  221.         the bottom.  At this point press any key or click the mouse to begin
  222.         the next hand.
  223.         
  224.           A demonstration mode is available.  Use a /d switch to start the
  225.         game and the computer will play against itself.  Press any key to
  226.         exit the program when running in demo mode.  You may also use /q
  227.         to turn on the Quiet mode (ie. No sound).
  228.           
  229.         
  230.                                   REGISTRATION
  231.         
  232.           This is a shareware game and if you like the game, I would
  233.         appreciate any donation you care to make.  I am asking for $10.00,
  234.         in U.S.  funds please.  Also for each additional $10.00 you send I
  235.         will send you another game based on the HA-TO card deck.  There are
  236.         two more games planned for the very near future.
  237.         
  238.           The other games play similar to MIN-HA-TO but the scoring is
  239.         completely different and the special card groups are different. 
  240.         The game of MIN-HA-TO is the older of the three, so it has fewer
  241.         rules and stipulations.  The two games under development are called
  242.         GO-STOP and YUK-BECK (Korean for 600).
  243.         
  244.           To register the game, print the file REGISTER.DOC using the DOS
  245.         command COPY REGISTER.DOC PRN, then fill out the form and mail it
  246.         to:
  247.         
  248.           Randy L. Pearson
  249.           3809 Ashland Drive
  250.           Huntsville, AL 35805
  251.         
  252.           Since this game is still in a testing stage I am looking for
  253.         errors in the program.  If you find a bug and mail me the first
  254.         description of the error, I will automatically register you for the
  255.         additional games.  I ask only for $5.00 to cover the cost of disks
  256.         and shipping.  Please provide the version number and a complete
  257.         description of your computer setup and exactly what was happening
  258.         when the error occurred.  This offer will expire on July 4th, 1992. 
  259.         I reserved the right to determine if the error you report is the
  260.         first time reported, and whether it is really a bug in program or
  261.         some other error in your system.
  262.  
  263.         
  264.                                  FINAL THOUGHTS
  265.         
  266.           This program is copyrighted 1992 by Randy L. Pearson.  Do not
  267.         attempt to sell or otherwise profit from the distribution of this
  268.         program.  Mail order distribution companies may only charge a
  269.         nominal fee designed to cover the cost of reproduction and shipping
  270.         and handling fees for this program.
  271.         
  272.           Since this is a copyrighted game, please do not attempt to
  273.         reverse engineer or modify the program code.  If you wish to have
  274.         a modified version, contact me and we can discuss the matter.
  275.         
  276.           What does RLP stand for?  It could be "Really Long Programs",
  277.         "Real Lousy Programs" or even "Real Life Programs".  What do you
  278.         think?
  279.         
  280.           One last thing.  Since I am in the military, I am subject to be
  281.         moved overseas at any time.  Military regulations prohibit using
  282.         the U.S. military postal system to operate a business.  If I am
  283.         sent overseas, I will no longer be able to mail registered users
  284.         copies of the new programs.  If this should happen, I will ask a
  285.         friend to continue the mailings.  Should this not be possible, any
  286.         money received while I am out of the country will be returned to
  287.         you.  I do not expect to be sent out of the country for another two
  288.         to three years, so this should not pose a problem, except for you
  289.         procastinators out there.
  290.        
  291.         Good luck and hope you enjoy the game!
  292.  
  293.         P.S.  I got an A in the class.  I get my grade from you based on
  294.               the number of registrations I receive.
  295.  
  296.  
  297. ___________________________________THE_END______________________________________
  298.